home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
MrmFetchBitmapLiteral.z
/
MrmFetchBitmapLiteral
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
NNNNAAAAMMMMEEEE
MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll - Fetches a bitmap literal from a
hierarchy
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Mrm/MrmPublic.h>
CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll(
MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,
SSSSttttrrrriiiinnnngggg iiiinnnnddddeeeexxxx,
SSSSccccrrrreeeeeeeennnn ****ssssccccrrrreeeeeeeennnn,
DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,
PPPPiiiixxxxmmmmaaaapppp ****ppppiiiixxxxmmmmaaaapppp____rrrreeeettttuuuurrrrnnnn,
DDDDiiiimmmmeeeennnnssssiiiioooonnnn ****wwwwiiiiddddtttthhhh,
DDDDiiiimmmmeeeennnnssssiiiioooonnnn ****hhhheeeeiiiigggghhhhtttt);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll function fetches a bitmap literal
from an MRM hierarchy, and converts the bitmap literal to an
X pixmap of depth 1. The function returns this pixmap and
its width and height.
_h_i_e_r_a_r_c_h_y__i_d
Specifies the ID of the UID hierarchy that
contains the specified icon literal. The value of
_h_i_e_r_a_r_c_h_y__i_d was returned in a previous call to
MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
_i_n_d_e_x Specifies the UIL name of the bitmap literal to
fetch.
_s_c_r_e_e_n Specifies the screen used for the pixmap. The
_s_c_r_e_e_n argument specifies a pointer to the Xlib
structure SSSSccccrrrreeeeeeeennnn which contains the information
about that screen and is linked to the DDDDiiiissssppppllllaaaayyyy
structure. For more information on the DDDDiiiissssppppllllaaaayyyy
and SSSSccccrrrreeeeeeeennnn structures, see the Xlib function
XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy and the associated screen information
macros.
_d_i_s_p_l_a_y Specifies the display used for the pixmap. The
_d_i_s_p_l_a_y argument specifies the connection to the X
server. For more information on the DDDDiiiissssppppllllaaaayyyy
structure, see the Xlib function XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy.
_p_i_x_m_a_p__r_e_t_u_r_n
Returns the resulting X pixmap value. The
function allocates space for this pixmap. The
application is responsible for managing the
allocated space. The application can recover the
Page 1 (printed 10/24/98)
MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
allocated space by calling XXXXmmmmDDDDeeeessssttttrrrrooooyyyyPPPPiiiixxxxmmmmaaaapppp.
_w_i_d_t_h Specifies a pointer to the width of the pixmap.
_h_e_i_g_h_t Specifies a pointer to the height of the pixmap.
RRRREEEETTTTUUUURRRRNNNN
This function returns one of the following status return
constants:
MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS
The function executed successfully.
MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
The hierarchy ID was invalid.
MMMMrrrrmmmmNNNNOOOOTTTT____FFFFOOOOUUUUNNNNDDDD
The bitmap literal was not found in the hierarchy.
MMMMrrrrmmmmWWWWRRRROOOONNNNGGGG____TTTTYYYYPPPPEEEE
The caller tried to fetch a literal of a type not
supported by this function.
MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE
The function failed.
RRRREEEELLLLAAAATTTTEEEEDDDD
MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll(3), MMMMrrrrmmmmFFFFeeeettttcccchhhhLLLLiiiitttteeeerrrraaaallll(3), and
XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy(3).
Page 2 (printed 10/24/98)